[“Physical Fractionation”, “Soil Fractionation”, “Soil Texture”]

Fractionation is the separation of different components within the soil, which can be done based on mineralogy - insert link, physical properties, biological properties - insert link, or chemical properties - insert link. To have a better understanding of soil, it is best to combine multiple processes to get a more in depth understanding. Once isolated, various approaches may be used to determine the composition and turnover of the isolated fraction(s) insert link to Kristy’s section.

What is it?

Physical fractionation, soils will be sorted by their size and potentially by their density (Gregorich et al, 2006). This process is based on the assumption that soil components and structure will determine its behavior and interactions. Physical fractionation includes separating samples by their: soil texture, particle size, aggregates and density. There are many permutations of physical fractionation methods in the literature (Figure 1), the research question should dictate what method is chosen.

Figure 1. Diagram utilized in order to compare different fraction methods. The acronyms are as follows: PSF = Particle size fractionation, PDF = Particle density fractionation, PSDF = Particle size density fractionation, ASF = Aggregate size fractionation, ADF = Aggregate density fractionation, and ASDF = Aggregate size density fraction. For more infromation, please refer to Moni et al., 2012.

Figure 1. Diagram utilized in order to compare different fraction methods. The acronyms are as follows: PSF = Particle size fractionation, PDF = Particle density fractionation, PSDF = Particle size density fractionation, ASF = Aggregate size fractionation, ADF = Aggregate density fractionation, and ASDF = Aggregate size density fraction. For more infromation, please refer to Moni et al., 2012.

Helpful Links:

  1. Brady, Niles, and Ray R. Weil. 2008. The Nature and Properties of Soil, 14th edition. Upper Saddle River, NJ: Prentice Hall.

  2. Christensen et al.(2001) DOI: 10.1046/j.1365-2389.2001.00417.x

  3. Elliott, E.T., Cambardella, C.A., 1991. Physical separation of soil organic matter. Agriculture,Ecosystems & Environment 34, 407–419.

  4. Gregorich, E. G., Beare, M. H., McKim, U. F., & Skjemstad, J. O. (2006). “Chemical and biological characteristics of physically uncomplexed organic matter.” Soil Science Society of America Journal, 70(3), 975-985.

  5. Moni, C., Derrien, D., Hatton, P.J., Zeller, B., & Kleber, M. (2012). “Density fractions versus size separates: does physical fraction isolate functional soil compartments?” Biogeosciences, 9, 5181-5197. DOI: 10.5194/bg-9-5181-2012

How do you separate them?

Soil Texture

Soil texture is the proportions of sand, silt, and clay within a sample of soil. Also, it can be defined as the look and feel of the soil sample, which is influenced by the type and the size of each particle. Sand, silt, and clay (Table 1 and Figure 2) particles are the basis of soil texture and combine into more specific texture classifications. For example, based on the particle content, clay can be broken down into sandy clay, silty clay, clay loam, sandy clay loam, or silty clay loam. Given a soil’s textural classification, information about the soil’s water holding capacity, productivity, and nutrient retention may be implied.

Table 1. Breakdown of the size classes as provided by the US Department of Agriculture (USDA).

Mineral Particle Particle Diameter Size (in millimeters)
Sand 2.0 - 0.05
Silt 0.05 - 0.002
Clay less than 0.002
Figure 2. Visual comparison of the size and shapes of each separate. Refer to the text written by Hillel for the original image.

Figure 2. Visual comparison of the size and shapes of each separate. Refer to the text written by Hillel for the original image.

Utilizing Soil Texture

The best way to determine the percentages of sand, silt, and clay is primarily through laboratory analysis. Of the procedures, the most common method to determine soil texture is through particle size analysis. However, if you do not have easy access to a laboratory, you can determine the texture class by feel. The USDA has provided a modified guide from Thien on their website (1979).Another method would be to utilize the Soil Textural Triangle (Figure 3).This particular classification method is dependent on the percentage of sand, silt, and clay. Soil texture is an important attribute for descriptive purposes, but does not change under land use, management, or experimentation.Therefore, is rarely a quantitative measure used in process-level or mechanistic studies.

Figure 3. The Soil Texture Triangle provided by the NRCS. If you would like to utilize this tool, please refer to the link.

Figure 3. The Soil Texture Triangle provided by the NRCS. If you would like to utilize this tool, please refer to the link.

Helpful Links

  1. Hillel, D. (2013). Fundamentals of soil physics. Academic press.

  2. Thien, S. J. (1979). A flow diagram for teaching texture-by-feel analysis. Journal of Agronomic Education, 8(2).

Particle Size Fractionation

As the name implies, this form of physical fractionation separates indvidual particles by their size. This can be done in different ways such as applying chemical, mechanical, or ultrasonic techinques. In order to divide the particle sizes, methods such as sieving or sedimentation can be utilized. With this type of fractionation, we eliminate any unwanted material and can quantify the different types of particles, aggregates, and other material within the sample.

Utilizing Particle Size Fractionation

The most commonly, researchers have utilized different techiques or devices to fit their needs. However, generally speaking, most will use sieves with different sized screens. Separation can either be done by hand or through a mechanized shaker. Along with using different tools, this method can be done either dry or wet. Through the wet process you can determine the sample’s water retention.

Figure 4. Soil samples that have been sieved at different sizes. The largest sized particles at 1-2 mm and smallest at 0.053-0.125 mm. Photo courtesy of Hannah Hubanks.

Figure 4. Soil samples that have been sieved at different sizes. The largest sized particles at 1-2 mm and smallest at 0.053-0.125 mm. Photo courtesy of Hannah Hubanks.

Helpful Links:

  1. Hillel, D. (2013). Fundamentals of soil physics. Academic press.

Aggregate Fractionation

According to Moni et al., this process is “based on the assumption that soil structure is a major control on [soil organic matter] turnover” (2012). This process will help understand more about the soil’s stability based on the shape of the aggregate.

Utilizing Aggregate Fractionation

When processing soil samples, initially, they are dried and larger stones and plant biomass will be removed by hand. To dry the sample, it can either be air dried or it can be placed in an oven. After the removal of larger particles, the sample will be pushed through sieves with different sized screens. Some screen sizes include: <2, 2-5, 5-20, or 20-50 μm (micrometers). Separation can either be done by hand or through equipment designed to shake samples. Some equipment includes rotaries, high speed mixers, shakers. It is noted that some equipment may be too abrasive for particles, while others may not properly disperse them (Whitbread, 1995).

Figure 5. Example of one fractionation process. For more information, please refer to this link.

Figure 5. Example of one fractionation process. For more information, please refer to this link.

Helpful Links:

  1. Gee, G. W., & Or, D. (2002). 2.4 Particle-size analysis. Methods of soil analysis. Part, 4(598),255-293.

  2. Kemper, W. D., and R. C. Rosenau. Aggregate stability and size distribution. (1986): 425-442.

  3. Puget, P., Chenu, C., & Balesdent, J. (2000). Dynamics of soil organic matter associated with particle‐size fractions of water‐stable aggregates. European Journal of Soil Science, 51(4), 595-605.

  4. Six J., Guggenberger G., Paustian K., Haumaier L., Elliott E.T. & Zech W. (2001) Sources and composition of soil organic matter fractions between and within aggregates.European Journal of Soil Science, 52, 607–618.

  5. Whitbread, A. M. (1995). Soil organic matter: its fractionation and role in soil structure. Soil organic matter management for sustainable agriculture, 124-130.

Density Fractionation

This method assumes that the soil can be separated into different parts and relies on separation based on densities. According Swanston et al., densities are referred to as simply the “heavy fraction” or the “light fraction” (2002). Through this method, we can better understand organic matter turnover and stabilization, which is associated with organic mineral interaction. With “heavy fractions”, there will be a low carbon to nitrogen ratio, which would indicate a slow turnover rate. While “light fractions”, there will be a higher carbon to nitrogen ratio, which would indicate faster turnover rates (Whitbread, 1995).

Figure 6. Flow chart of a multi-part fractionation. This particular process includes breakdown of macroaggregates via wet sieving coupled with a density fraction to further separate the sample. Please refer to the original paper for more information.

Figure 6. Flow chart of a multi-part fractionation. This particular process includes breakdown of macroaggregates via wet sieving coupled with a density fraction to further separate the sample. Please refer to the original paper for more information.

Utilizing Density Fractionation

In order to perform a density fractionation, inorganic or organic liquids may be used. This includes bromoform-ethanol mixtures, tetrachlromethane, sodium iodide, and sodium polytungstate (SPT). Most commonly, labs will utilize SPT as a result of its ability to isolate two or more fractions. The mixture often is centrifuged in order to facilitate separation, and the result is a fraction that floats on a given density and one that sinks.

Helpful Links:

  1. Crow et al. (2007) DOI: 10.1007/s10533-007-9100-8

  3. Swanston, C. W., B. A., Homann, P. S., Ganio, L., & Sollins, P. (2002). Carbon synamics during a long-term incubation of separate and recombined density fractions from seven forest soils. Soil Biology and Biochemistry, 34 (8), 1121-1130.

Applications of Physical Fractions

LS0tCnRpdGxlOiAiUGh5c2ljYWwgRnJhY3Rpb25zIgphdXRob3I6ICJLYWVsaW4gU3lsdmEiCmRhdGU6ICJGZWJydWFyeSAxOCwgMjAxOCIKb3V0cHV0OiBodG1sX25vdGVib29rCi0tLQoKWyJQaHlzaWNhbCBGcmFjdGlvbmF0aW9uIiwgIlNvaWwgRnJhY3Rpb25hdGlvbiIsICJTb2lsIFRleHR1cmUiXQoKKioqCiAKRnJhY3Rpb25hdGlvbiBpcyB0aGUgc2VwYXJhdGlvbiBvZiBkaWZmZXJlbnQgY29tcG9uZW50cyB3aXRoaW4gdGhlIHNvaWwsIHdoaWNoIGNhbiBiZSBkb25lIGJhc2VkIG9uICoqbWluZXJhbG9neSAtIGluc2VydCBsaW5rKiosIHBoeXNpY2FsIHByb3BlcnRpZXMsICoqYmlvbG9naWNhbCBwcm9wZXJ0aWVzIC0gaW5zZXJ0IGxpbmsqKiwgb3IgKipjaGVtaWNhbCBwcm9wZXJ0aWVzIC0gaW5zZXJ0IGxpbmsqKi4gVG8gaGF2ZSBhIGJldHRlciB1bmRlcnN0YW5kaW5nIG9mIHNvaWwsIGl0IGlzIGJlc3QgdG8gY29tYmluZSBtdWx0aXBsZSBwcm9jZXNzZXMgdG8gZ2V0IGEgbW9yZSBpbiBkZXB0aCB1bmRlcnN0YW5kaW5nLiBPbmNlIGlzb2xhdGVkLCB2YXJpb3VzIGFwcHJvYWNoZXMgbWF5IGJlIHVzZWQgdG8gZGV0ZXJtaW5lIHRoZSBjb21wb3NpdGlvbiBhbmQgdHVybm92ZXIgb2YgdGhlIGlzb2xhdGVkIGZyYWN0aW9uKHMpICoqaW5zZXJ0IGxpbmsgdG8gS3Jpc3R54oCZcyBzZWN0aW9uKiouCgoqKioKIyMjV2hhdCBpcyBpdD8gIAoKUGh5c2ljYWwgZnJhY3Rpb25hdGlvbiwgc29pbHMgd2lsbCBiZSBzb3J0ZWQgYnkgdGhlaXIgc2l6ZSBhbmQgcG90ZW50aWFsbHkgYnkgdGhlaXIgZGVuc2l0eSAoR3JlZ29yaWNoIGV0IGFsLCAyMDA2KS4gVGhpcyBwcm9jZXNzIGlzIGJhc2VkIG9uIHRoZSBhc3N1bXB0aW9uIHRoYXQgc29pbCBjb21wb25lbnRzIGFuZCBzdHJ1Y3R1cmUgd2lsbCBkZXRlcm1pbmUgaXRzIGJlaGF2aW9yIGFuZCBpbnRlcmFjdGlvbnMuIFBoeXNpY2FsIGZyYWN0aW9uYXRpb24gaW5jbHVkZXMgc2VwYXJhdGluZyBzYW1wbGVzIGJ5IHRoZWlyOiBzb2lsIHRleHR1cmUsIHBhcnRpY2xlIHNpemUsIGFnZ3JlZ2F0ZXMgYW5kIGRlbnNpdHkuIFRoZXJlIGFyZSBtYW55IHBlcm11dGF0aW9ucyBvZiBwaHlzaWNhbCBmcmFjdGlvbmF0aW9uIG1ldGhvZHMgaW4gdGhlIGxpdGVyYXR1cmUgKEZpZ3VyZSAxKSwgdGhlIHJlc2VhcmNoIHF1ZXN0aW9uIHNob3VsZCBkaWN0YXRlIHdoYXQgbWV0aG9kIGlzIGNob3Nlbi4KCiFbRmlndXJlIDEuIERpYWdyYW0gdXRpbGl6ZWQgaW4gb3JkZXIgdG8gY29tcGFyZSBkaWZmZXJlbnQgZnJhY3Rpb24gbWV0aG9kcy4gVGhlIGFjcm9ueW1zIGFyZSBhcyBmb2xsb3dzOiBQU0YgPSBQYXJ0aWNsZSBzaXplIGZyYWN0aW9uYXRpb24sIFBERiA9IFBhcnRpY2xlIGRlbnNpdHkgZnJhY3Rpb25hdGlvbiwgUFNERiA9IFBhcnRpY2xlIHNpemUgZGVuc2l0eSBmcmFjdGlvbmF0aW9uLCBBU0YgPSBBZ2dyZWdhdGUgc2l6ZSBmcmFjdGlvbmF0aW9uLCBBREYgPSBBZ2dyZWdhdGUgZGVuc2l0eSBmcmFjdGlvbmF0aW9uLCBhbmQgQVNERiA9IEFnZ3JlZ2F0ZSBzaXplIGRlbnNpdHkgZnJhY3Rpb24uIEZvciBtb3JlIGluZnJvbWF0aW9uLCBwbGVhc2UgcmVmZXIgdG8gTW9uaSBldCBhbC4sIDIwMTIuXShGaWd1cmUxLnBuZyl7d2lkdGg9NzUlfQogIAoqKkhlbHBmdWwgTGlua3M6KiogIAoKMS4gQnJhZHksIE5pbGVzLCBhbmQgUmF5IFIuIFdlaWwuIDIwMDguIFRoZSBOYXR1cmUgYW5kIFByb3BlcnRpZXMgb2YgU29pbCwgMTR0aCBlZGl0aW9uLiBVcHBlciBTYWRkbGUgUml2ZXIsIE5KOiBQcmVudGljZSBIYWxsLiAgCgoyLiBDaHJpc3RlbnNlbiBldCBhbC4oMjAwMSkgRE9JOiAxMC4xMDQ2L2ouMTM2NS0yMzg5LjIwMDEuMDA0MTcueCAgCgozLiBFbGxpb3R0LCBFLlQuLCBDYW1iYXJkZWxsYSwgQy5BLiwgMTk5MS4gUGh5c2ljYWwgc2VwYXJhdGlvbiBvZiBzb2lsIG9yZ2FuaWMgbWF0dGVyLiBBZ3JpY3VsdHVyZSxFY29zeXN0ZW1zICYgRW52aXJvbm1lbnQgMzQsIDQwN+KAkzQxOS4gIAoKNC4gR3JlZ29yaWNoLCBFLiBHLiwgQmVhcmUsIE0uIEguLCBNY0tpbSwgVS4gRi4sICYgU2tqZW1zdGFkLCBKLiBPLiAoMjAwNikuICJDaGVtaWNhbCBhbmQgYmlvbG9naWNhbCBjaGFyYWN0ZXJpc3RpY3Mgb2YgcGh5c2ljYWxseSB1bmNvbXBsZXhlZCBvcmdhbmljIG1hdHRlci4iIFNvaWwgU2NpZW5jZSBTb2NpZXR5IG9mIEFtZXJpY2EgSm91cm5hbCwgNzAoMyksIDk3NS05ODUuICAKCjUuICBNb25pLCBDLiwgRGVycmllbiwgRC4sIEhhdHRvbiwgUC5KLiwgWmVsbGVyLCBCLiwgJiBLbGViZXIsIE0uICgyMDEyKS4gIkRlbnNpdHkgZnJhY3Rpb25zIHZlcnN1cyBzaXplIHNlcGFyYXRlczogZG9lcyBwaHlzaWNhbCBmcmFjdGlvbiBpc29sYXRlIGZ1bmN0aW9uYWwgc29pbCBjb21wYXJ0bWVudHM/IiBCaW9nZW9zY2llbmNlcywgOSwgNTE4MS01MTk3LiBET0k6IFsxMC41MTk0L2JnLTktNTE4MS0yMDEyXShodHRwczovL3d3dy5iaW9nZW9zY2llbmNlcy5uZXQvOS81MTgxLzIwMTIvYmctOS01MTgxLTIwMTIucGRmKQoKKioqCiMjI0hvdyBkbyB5b3Ugc2VwYXJhdGUgdGhlbT8gCgojIyMjU29pbCBUZXh0dXJlCgpTb2lsIHRleHR1cmUgaXMgdGhlIHByb3BvcnRpb25zIG9mIHNhbmQsIHNpbHQsIGFuZCBjbGF5IHdpdGhpbiBhIHNhbXBsZSBvZiBzb2lsLiBBbHNvLCBpdCBjYW4gYmUgZGVmaW5lZCBhcyB0aGUgbG9vayBhbmQgZmVlbCBvZiB0aGUgc29pbCBzYW1wbGUsIHdoaWNoIGlzIGluZmx1ZW5jZWQgYnkgdGhlIHR5cGUgYW5kIHRoZSBzaXplIG9mIGVhY2ggcGFydGljbGUuIFNhbmQsIHNpbHQsIGFuZCBjbGF5IChUYWJsZSAxIGFuZCBGaWd1cmUgMikgcGFydGljbGVzIGFyZSB0aGUgYmFzaXMgb2Ygc29pbCB0ZXh0dXJlIGFuZCBjb21iaW5lIGludG8gbW9yZSBzcGVjaWZpYyB0ZXh0dXJlIGNsYXNzaWZpY2F0aW9ucy4gRm9yIGV4YW1wbGUsIGJhc2VkIG9uIHRoZSBwYXJ0aWNsZSBjb250ZW50LCBjbGF5IGNhbiBiZSBicm9rZW4gZG93biBpbnRvIHNhbmR5IGNsYXksIHNpbHR5IGNsYXksIGNsYXkgbG9hbSwgc2FuZHkgY2xheSBsb2FtLCBvciBzaWx0eSBjbGF5IGxvYW0uIEdpdmVuIGEgc29pbOKAmXMgdGV4dHVyYWwgY2xhc3NpZmljYXRpb24sIGluZm9ybWF0aW9uIGFib3V0IHRoZSBzb2ls4oCZcyB3YXRlciBob2xkaW5nIGNhcGFjaXR5LCBwcm9kdWN0aXZpdHksIGFuZCBudXRyaWVudCByZXRlbnRpb24gbWF5IGJlIGltcGxpZWQuCgpUYWJsZSAxLiBCcmVha2Rvd24gb2YgdGhlIHNpemUgY2xhc3NlcyBhcyBwcm92aWRlZCBieSB0aGUgVVMgRGVwYXJ0bWVudCBvZiBBZ3JpY3VsdHVyZSAoVVNEQSkuICAKCk1pbmVyYWwgUGFydGljbGUgIHwgUGFydGljbGUgRGlhbWV0ZXIgU2l6ZSAoaW4gbWlsbGltZXRlcnMpCi0tLS0tLS0tLS0tLS0tLS0tIHwgLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tClNhbmQgICAgICAgICAgICAgIHwgMi4wIC0gMC4wNQpTaWx0ICAgICAgICAgICAgICB8IDAuMDUgLSAwLjAwMgpDbGF5ICAgICAgICAgICAgICB8IGxlc3MgdGhhbiAwLjAwMgogCiAKIVtGaWd1cmUgMi4gVmlzdWFsIGNvbXBhcmlzb24gb2YgdGhlIHNpemUgYW5kIHNoYXBlcyBvZiBlYWNoIHNlcGFyYXRlLiBSZWZlciB0byB0aGUgdGV4dCB3cml0dGVuIGJ5IEhpbGxlbCBmb3IgdGhlIG9yaWdpbmFsIGltYWdlLl0oSU1HXzEwMTAuanBnKXt3aWR0aD02MCV9CgogCioqVXRpbGl6aW5nIFNvaWwgVGV4dHVyZSoqIAoKVGhlIGJlc3Qgd2F5IHRvIGRldGVybWluZSB0aGUgcGVyY2VudGFnZXMgb2Ygc2FuZCwgc2lsdCwgYW5kIGNsYXkgaXMgcHJpbWFyaWx5IHRocm91Z2ggbGFib3JhdG9yeSBhbmFseXNpcy4gT2YgdGhlIHByb2NlZHVyZXMsIHRoZSBtb3N0IGNvbW1vbiBtZXRob2QgdG8gZGV0ZXJtaW5lIHNvaWwgdGV4dHVyZSBpcyB0aHJvdWdoIHBhcnRpY2xlIHNpemUgYW5hbHlzaXMuIEhvd2V2ZXIsIGlmIHlvdSBkbyBub3QgaGF2ZSBlYXN5IGFjY2VzcyB0byBhIGxhYm9yYXRvcnksIHlvdSBjYW4gZGV0ZXJtaW5lIHRoZSB0ZXh0dXJlIGNsYXNzIGJ5IGZlZWwuIFRoZSBVU0RBIGhhcyBwcm92aWRlZCBhIG1vZGlmaWVkIGd1aWRlIGZyb20gVGhpZW4gb24gdGhlaXIgW3dlYnNpdGVdKGh0dHBzOi8vd3d3Lm5yY3MudXNkYS5nb3Yvd3BzL3BvcnRhbC9ucmNzL2RldGFpbC9zb2lscy9lZHUvP2NpZD1ucmNzMTQycDJfMDU0MzExKSAoMTk3OSkuQW5vdGhlciBtZXRob2Qgd291bGQgYmUgdG8gdXRpbGl6ZSB0aGUgU29pbCBUZXh0dXJhbCBUcmlhbmdsZSAoRmlndXJlIDMpLlRoaXMgcGFydGljdWxhciBjbGFzc2lmaWNhdGlvbiBtZXRob2QgaXMgZGVwZW5kZW50IG9uIHRoZSBwZXJjZW50YWdlIG9mIHNhbmQsIHNpbHQsIGFuZCBjbGF5LiBTb2lsIHRleHR1cmUgaXMgYW4gaW1wb3J0YW50IGF0dHJpYnV0ZSBmb3IgZGVzY3JpcHRpdmUgcHVycG9zZXMsIGJ1dCBkb2VzIG5vdCBjaGFuZ2UgdW5kZXIgbGFuZCB1c2UsIG1hbmFnZW1lbnQsIG9yIGV4cGVyaW1lbnRhdGlvbi5UaGVyZWZvcmUsIGlzIHJhcmVseSBhIHF1YW50aXRhdGl2ZSBtZWFzdXJlIHVzZWQgaW4gcHJvY2Vzcy1sZXZlbCBvciBtZWNoYW5pc3RpYyBzdHVkaWVzLgogIAohW0ZpZ3VyZSAzLiBUaGUgU29pbCBUZXh0dXJlIFRyaWFuZ2xlIHByb3ZpZGVkIGJ5IHRoZSBOUkNTLiBJZiB5b3Ugd291bGQgbGlrZSB0byB1dGlsaXplIHRoaXMgdG9vbCwgcGxlYXNlIHJlZmVyIHRvIHRoZSBbbGlua10oaHR0cHM6Ly93d3cubnJjcy51c2RhLmdvdi93cHMvcG9ydGFsL25yY3MvZGV0YWlsL3NvaWxzL3N1cnZleS8/Y2lkPW5yY3MxNDJwMl8wNTQxNjcpLl0oU29pbF9UZXh0dXJhbF9UcmlhbmdsZS5qcGcpe3dpZHRoPTc1JX0KICAKKipIZWxwZnVsIExpbmtzKiogIAoKNi4gSGlsbGVsLCBELiAoMjAxMykuIEZ1bmRhbWVudGFscyBvZiBzb2lsIHBoeXNpY3MuIEFjYWRlbWljIHByZXNzLiAgCgo3LiBUaGllbiwgUy4gSi4gKDE5NzkpLiBBIGZsb3cgZGlhZ3JhbSBmb3IgdGVhY2hpbmcgdGV4dHVyZS1ieS1mZWVsIGFuYWx5c2lzLiBKb3VybmFsIG9mIEFncm9ub21pYyBFZHVjYXRpb24sIDgoMikuCgoqKioKIyMjI1BhcnRpY2xlIFNpemUgRnJhY3Rpb25hdGlvbgoKQXMgdGhlIG5hbWUgaW1wbGllcywgdGhpcyBmb3JtIG9mIHBoeXNpY2FsIGZyYWN0aW9uYXRpb24gc2VwYXJhdGVzIGluZHZpZHVhbCBwYXJ0aWNsZXMgYnkgdGhlaXIgc2l6ZS4gVGhpcyBjYW4gYmUgZG9uZSBpbiBkaWZmZXJlbnQgd2F5cyBzdWNoIGFzIGFwcGx5aW5nIGNoZW1pY2FsLCBtZWNoYW5pY2FsLCBvciB1bHRyYXNvbmljIHRlY2hpbnF1ZXMuIEluIG9yZGVyIHRvIGRpdmlkZSB0aGUgcGFydGljbGUgc2l6ZXMsIG1ldGhvZHMgc3VjaCBhcyBzaWV2aW5nIG9yIHNlZGltZW50YXRpb24gY2FuIGJlIHV0aWxpemVkLiBXaXRoIHRoaXMgdHlwZSBvZiBmcmFjdGlvbmF0aW9uLCB3ZSBlbGltaW5hdGUgYW55IHVud2FudGVkIG1hdGVyaWFsIGFuZCBjYW4gcXVhbnRpZnkgdGhlIGRpZmZlcmVudCB0eXBlcyBvZiBwYXJ0aWNsZXMsIGFnZ3JlZ2F0ZXMsIGFuZCBvdGhlciBtYXRlcmlhbCB3aXRoaW4gdGhlIHNhbXBsZS4gCiAgCioqVXRpbGl6aW5nIFBhcnRpY2xlIFNpemUgRnJhY3Rpb25hdGlvbioqCgpUaGUgbW9zdCBjb21tb25seSwgcmVzZWFyY2hlcnMgaGF2ZSB1dGlsaXplZCBkaWZmZXJlbnQgdGVjaGlxdWVzIG9yIGRldmljZXMgdG8gZml0IHRoZWlyIG5lZWRzLiBIb3dldmVyLCBnZW5lcmFsbHkgc3BlYWtpbmcsIG1vc3Qgd2lsbCB1c2Ugc2lldmVzIHdpdGggZGlmZmVyZW50IHNpemVkIHNjcmVlbnMuIFNlcGFyYXRpb24gY2FuIGVpdGhlciBiZSBkb25lIGJ5IGhhbmQgb3IgdGhyb3VnaCBhIG1lY2hhbml6ZWQgc2hha2VyLiBBbG9uZyB3aXRoIHVzaW5nIGRpZmZlcmVudCB0b29scywgdGhpcyBtZXRob2QgY2FuIGJlIGRvbmUgZWl0aGVyIGRyeSBvciB3ZXQuIFRocm91Z2ggdGhlIHdldCBwcm9jZXNzIHlvdSBjYW4gZGV0ZXJtaW5lIHRoZSBzYW1wbGUncyB3YXRlciByZXRlbnRpb24uICAKCiFbRmlndXJlIDQuIFNvaWwgc2FtcGxlcyB0aGF0IGhhdmUgYmVlbiBzaWV2ZWQgYXQgZGlmZmVyZW50IHNpemVzLiBUaGUgbGFyZ2VzdCBzaXplZCBwYXJ0aWNsZXMgYXQgMS0yIG1tIGFuZCBzbWFsbGVzdCBhdCAwLjA1My0wLjEyNSBtbS4gUGhvdG8gY291cnRlc3kgb2YgSGFubmFoIEh1YmFua3MuIF0oSU1HXzAwMTUuanBnKXt3aWR0aD01NSV9CiAgCioqSGVscGZ1bCBMaW5rczoqKiAgCgo4LiBIaWxsZWwsIEQuICgyMDEzKS4gKkZ1bmRhbWVudGFscyBvZiBzb2lsIHBoeXNpY3MqLiBBY2FkZW1pYyBwcmVzcy4KCioqKgojIyMjQWdncmVnYXRlIEZyYWN0aW9uYXRpb24gIAoKQWNjb3JkaW5nIHRvIE1vbmkgZXQgYWwuLCB0aGlzIHByb2Nlc3MgaXMgImJhc2VkIG9uIHRoZSBhc3N1bXB0aW9uIHRoYXQgc29pbCBzdHJ1Y3R1cmUgaXMgYSBtYWpvciBjb250cm9sIG9uIFtzb2lsIG9yZ2FuaWMgbWF0dGVyXSB0dXJub3ZlciIgKDIwMTIpLiBUaGlzIHByb2Nlc3Mgd2lsbCBoZWxwIHVuZGVyc3RhbmQgbW9yZSBhYm91dCB0aGUgc29pbCdzIHN0YWJpbGl0eSBiYXNlZCBvbiB0aGUgc2hhcGUgb2YgdGhlIGFnZ3JlZ2F0ZS4gIAoKKipVdGlsaXppbmcgQWdncmVnYXRlIEZyYWN0aW9uYXRpb24qKgogIApXaGVuIHByb2Nlc3Npbmcgc29pbCBzYW1wbGVzLCBpbml0aWFsbHksIHRoZXkgYXJlIGRyaWVkIGFuZCBsYXJnZXIgc3RvbmVzIGFuZCBwbGFudCBiaW9tYXNzIHdpbGwgYmUgcmVtb3ZlZCBieSBoYW5kLiBUbyBkcnkgdGhlIHNhbXBsZSwgaXQgY2FuIGVpdGhlciBiZSBhaXIgZHJpZWQgb3IgaXQgY2FuIGJlIHBsYWNlZCBpbiBhbiBvdmVuLiBBZnRlciB0aGUgcmVtb3ZhbCBvZiBsYXJnZXIgcGFydGljbGVzLCB0aGUgc2FtcGxlIHdpbGwgYmUgcHVzaGVkIHRocm91Z2ggc2lldmVzIHdpdGggZGlmZmVyZW50IHNpemVkIHNjcmVlbnMuIFNvbWUgc2NyZWVuIHNpemVzIGluY2x1ZGU6IDwyLCAyLTUsIDUtMjAsIG9yIDIwLTUwIM68bSAobWljcm9tZXRlcnMpLiBTZXBhcmF0aW9uIGNhbiBlaXRoZXIgYmUgZG9uZSBieSBoYW5kIG9yIHRocm91Z2ggZXF1aXBtZW50IGRlc2lnbmVkIHRvIHNoYWtlIHNhbXBsZXMuIFNvbWUgZXF1aXBtZW50IGluY2x1ZGVzIHJvdGFyaWVzLCBoaWdoIHNwZWVkIG1peGVycywgc2hha2Vycy4gSXQgaXMgbm90ZWQgdGhhdCBzb21lIGVxdWlwbWVudCBtYXkgYmUgdG9vIGFicmFzaXZlIGZvciBwYXJ0aWNsZXMsIHdoaWxlIG90aGVycyBtYXkgbm90IHByb3Blcmx5IGRpc3BlcnNlIHRoZW0gKFdoaXRicmVhZCwgMTk5NSkuIAoKIVtGaWd1cmUgNS4gRXhhbXBsZSBvZiBvbmUgZnJhY3Rpb25hdGlvbiBwcm9jZXNzLiBGb3IgbW9yZSBpbmZvcm1hdGlvbiwgcGxlYXNlIHJlZmVyIHRvIHRoaXMgW2xpbmsuXShodHRwczovL3d3dy5yZXNlYXJjaGdhdGUubmV0L3Byb2ZpbGUvQ2xhaXJlX0NoZW51L3B1YmxpY2F0aW9uLzIyOTkxNTQ2NV9EeW5hbWljc19vZl9zb2lsX29yZ2FuaWNfbWF0dGVyX2Fzc29jaWF0ZWRfd2l0aF9wYXJ0aWNsZS1zaXplX2ZyYWN0aW9uc19vZl93YXRlci1zdGFibGVfYWdncmVnYXRlcy9saW5rcy81NmM4ZDlkYTA4YWUxMTA2MzcwNzhmM2MucGRmKSBdKEZpZ3VyZTVpc2gucG5nKXt3aWR0aD01MCV9CiAgCioqSGVscGZ1bCBMaW5rczoqKiAgCgo5LiBHZWUsIEcuIFcuLCAmIE9yLCBELiAoMjAwMikuIDIuNCBQYXJ0aWNsZS1zaXplIGFuYWx5c2lzLiBNZXRob2RzIG9mIHNvaWwgYW5hbHlzaXMuIFBhcnQsIDQoNTk4KSwyNTUtMjkzLiAgCgoxMC4gS2VtcGVyLCBXLiBELiwgYW5kIFIuIEMuIFJvc2VuYXUuIEFnZ3JlZ2F0ZSBzdGFiaWxpdHkgYW5kIHNpemUgZGlzdHJpYnV0aW9uLiAoMTk4Nik6IDQyNS00NDIuICAKCjExLiBQdWdldCwgUC4sIENoZW51LCBDLiwgJiBCYWxlc2RlbnQsIEouICgyMDAwKS4gRHluYW1pY3Mgb2Ygc29pbCBvcmdhbmljIG1hdHRlciBhc3NvY2lhdGVkIHdpdGggcGFydGljbGXigJBzaXplIGZyYWN0aW9ucyBvZiB3YXRlcuKAkHN0YWJsZSBhZ2dyZWdhdGVzLiBFdXJvcGVhbiBKb3VybmFsIG9mIFNvaWwgU2NpZW5jZSwgNTEoNCksIDU5NS02MDUuICAKCjEyLiBTaXggSi4sIEd1Z2dlbmJlcmdlciBHLiwgUGF1c3RpYW4gSy4sIEhhdW1haWVyIEwuLCBFbGxpb3R0IEUuVC4gJiBaZWNoIFcuICgyMDAxKSBTb3VyY2VzIGFuZCBjb21wb3NpdGlvbiBvZiBzb2lsIG9yZ2FuaWMgbWF0dGVyIGZyYWN0aW9ucyBiZXR3ZWVuIGFuZCB3aXRoaW4gYWdncmVnYXRlcy5FdXJvcGVhbiBKb3VybmFsIG9mIFNvaWwgU2NpZW5jZSwgNTIsIDYwN+KAkzYxOC4KCjEzLiBXaGl0YnJlYWQsIEEuIE0uICgxOTk1KS4gU29pbCBvcmdhbmljIG1hdHRlcjogaXRzIGZyYWN0aW9uYXRpb24gYW5kIHJvbGUgaW4gc29pbCBzdHJ1Y3R1cmUuIFNvaWwgb3JnYW5pYyBtYXR0ZXIgbWFuYWdlbWVudCBmb3Igc3VzdGFpbmFibGUgYWdyaWN1bHR1cmUsIDEyNC0xMzAuICAKCioqKgojIyMjRGVuc2l0eSBGcmFjdGlvbmF0aW9uICAKClRoaXMgbWV0aG9kIGFzc3VtZXMgdGhhdCB0aGUgc29pbCBjYW4gYmUgc2VwYXJhdGVkIGludG8gZGlmZmVyZW50IHBhcnRzIGFuZCByZWxpZXMgb24gc2VwYXJhdGlvbiBiYXNlZCBvbiBkZW5zaXRpZXMuIEFjY29yZGluZyBTd2Fuc3RvbiBldCBhbC4sIGRlbnNpdGllcyBhcmUgIHJlZmVycmVkIHRvIGFzIHNpbXBseSB0aGUg4oCcaGVhdnkgZnJhY3Rpb27igJ0gb3IgdGhlIOKAnGxpZ2h0IGZyYWN0aW9u4oCdICgyMDAyKS4gVGhyb3VnaCB0aGlzIG1ldGhvZCwgd2UgY2FuIGJldHRlciB1bmRlcnN0YW5kIG9yZ2FuaWMgbWF0dGVyIHR1cm5vdmVyIGFuZCBzdGFiaWxpemF0aW9uLCB3aGljaCBpcyBhc3NvY2lhdGVkIHdpdGggb3JnYW5pYyBtaW5lcmFsIGludGVyYWN0aW9uLiBXaXRoIOKAnGhlYXZ5IGZyYWN0aW9uc+KAnSwgdGhlcmUgd2lsbCBiZSBhIGxvdyBjYXJib24gdG8gbml0cm9nZW4gcmF0aW8sIHdoaWNoIHdvdWxkIGluZGljYXRlIGEgc2xvdyB0dXJub3ZlciByYXRlLiBXaGlsZSDigJxsaWdodCBmcmFjdGlvbnPigJ0sIHRoZXJlIHdpbGwgYmUgYSBoaWdoZXIgY2FyYm9uIHRvIG5pdHJvZ2VuIHJhdGlvLCB3aGljaCB3b3VsZCBpbmRpY2F0ZSBmYXN0ZXIgdHVybm92ZXIgcmF0ZXMgKFdoaXRicmVhZCwgMTk5NSkuICAKIAohW0ZpZ3VyZSA2LiBGbG93IGNoYXJ0IG9mIGEgbXVsdGktcGFydCBmcmFjdGlvbmF0aW9uLiBUaGlzIHBhcnRpY3VsYXIgcHJvY2VzcyBpbmNsdWRlcyBicmVha2Rvd24gb2YgbWFjcm9hZ2dyZWdhdGVzIHZpYSB3ZXQgc2lldmluZyBjb3VwbGVkIHdpdGggYSBkZW5zaXR5IGZyYWN0aW9uIHRvIGZ1cnRoZXIgc2VwYXJhdGUgdGhlIHNhbXBsZS4gUGxlYXNlIHJlZmVyIHRvIHRoZSBvcmlnaW5hbCBbcGFwZXJdKGh0dHBzOi8vd3d3LnJlc2VhcmNoZ2F0ZS5uZXQvcHJvZmlsZS9Nb2hhbW1lZF9LYWRlci9wdWJsaWNhdGlvbi8yNjUwMjE5NDdfQ09NUEFSSVNPTl9PRl9QSFlTSUNBTF9GUkFDVElPTkFUSU9OX01FVEhPRFNfVE9fU0VQQVJBVEVfRlVOQ1RJT05BTF9TT0lMX09SR0FOSUNfTUFUVEVSX1BPT0xTL2xpbmtzLzU5ZTVhNGVmNDU4NTE1MjUwMjUwODg2Yy9DT01QQVJJU09OLU9GLVBIWVNJQ0FMLUZSQUNUSU9OQVRJT04tTUVUSE9EUy1UTy1TRVBBUkFURS1GVU5DVElPTkFMLVNPSUwtT1JHQU5JQy1NQVRURVItUE9PTFMucGRmKSBmb3IgbW9yZSBpbmZvcm1hdGlvbi5dKEZyYWN0aW9uYXRpb25fUHJvY2Vzc19EZW5zaXR5LnBuZyl7d2lkdGg9NTUlfQogIAoqKlV0aWxpemluZyBEZW5zaXR5IEZyYWN0aW9uYXRpb24qKgogIApJbiBvcmRlciB0byBwZXJmb3JtIGEgZGVuc2l0eSBmcmFjdGlvbmF0aW9uLCBpbm9yZ2FuaWMgb3Igb3JnYW5pYyBsaXF1aWRzIG1heSBiZSB1c2VkLiBUaGlzIGluY2x1ZGVzIGJyb21vZm9ybS1ldGhhbm9sIG1peHR1cmVzLCB0ZXRyYWNobHJvbWV0aGFuZSwgc29kaXVtIGlvZGlkZSwgYW5kIHNvZGl1bSBwb2x5dHVuZ3N0YXRlIChTUFQpLiBNb3N0IGNvbW1vbmx5LCBsYWJzIHdpbGwgdXRpbGl6ZSBTUFQgYXMgYSByZXN1bHQgb2YgaXRzIGFiaWxpdHkgdG8gaXNvbGF0ZSB0d28gb3IgbW9yZSBmcmFjdGlvbnMuIFRoZSBtaXh0dXJlIG9mdGVuIGlzIGNlbnRyaWZ1Z2VkIGluIG9yZGVyIHRvIGZhY2lsaXRhdGUgc2VwYXJhdGlvbiwgYW5kIHRoZSByZXN1bHQgaXMgYSBmcmFjdGlvbiB0aGF0IGZsb2F0cyBvbiBhIGdpdmVuIGRlbnNpdHkgYW5kIG9uZSB0aGF0IHNpbmtzLiAKCioqSGVscGZ1bCBMaW5rczoqKiAgCgoxNC4gQ3JvdyBldCBhbC4gKDIwMDcpIERPSTogWzEwLjEwMDcvczEwNTMzLTAwNy05MTAwLThdKGh0dHBzOi8vd3d3Lm5ycy5mcy5mZWQudXMvcHVicy9qcm5sLzIwMDcvbnJzXzIwMDdfY3Jvd18wMDEucGRmKSAKCjE1LiAgCiAgCjE2LiBTd2Fuc3RvbiwgQy4gVy4sIEIuIEEuLCBIb21hbm4sIFAuIFMuLCBHYW5pbywgTC4sICYgU29sbGlucywgUC4gKDIwMDIpLiBDYXJib24gc3luYW1pY3MgZHVyaW5nIGEgbG9uZy10ZXJtIGluY3ViYXRpb24gb2Ygc2VwYXJhdGUgYW5kIHJlY29tYmluZWQgZGVuc2l0eSBmcmFjdGlvbnMgZnJvbSBzZXZlbiBmb3Jlc3Qgc29pbHMuIFNvaWwgQmlvbG9neSBhbmQgQmlvY2hlbWlzdHJ5LCAzNCAoOCksIDExMjEtMTEzMC4KCioqKgoKIyMjQXBwbGljYXRpb25zIG9mIFBoeXNpY2FsIEZyYWN0aW9ucwoKLSBTb2lsIFRleHR1cmUgICAgCiAgICArIFN1bW1hcnkgb2YgYSBwYXBlciAKICAgICsgSG93IGl0IGFwcGxpZXMgdG8gU29pbCBDICAKICAgIAotIFBhcnRpY2xlIFNpemUgRnJhY3Rpb25hdGlvbiAgCiAgICArIFN1bW1hcnkgb2YgYSBwYXBlciAKICAgICsgSG93IGl0IGFwcGxpZXMgdG8gU29pbCBDICAKU2lsdmEsIEouIEguLCBEZWVuaWssIEouIEwuLCBZb3N0LCBSLiBTLiwgQnJ1bGFuZCwgRy4gTC4sICYgQ3JvdywgUy4gRS4gKDIwMTUpLiAiSW1wcm92aW5nIGNsYXkgY29udGVudCBtZWFzdXJlbWVudCBpbiBveGlkaWMgYW5kIHZvbGNhbmljIGFzaCBzb2lscyBvZiBIYXdhaWkgYnkgaW5jcmVhc2luZyBkaXNwZXJzYW50IGNvbmNlbnRyYXRpb24gYW5kIHVsdHJhc29uaWMgZW5lcmd5IGxldmVscyIuIEdlb2Rlcm1hLCAyMzcsIDIxMS0yMjMuIERPSTogWzEwLjEwMTYvSi5HRU9ERVJNQS4yMDE0LjA5LjAwOF0oaHR0cHM6Ly9zMy5hbWF6b25hd3MuY29tL2FjYWRlbWlhLmVkdS5kb2N1bWVudHMvMzgwNjQ4NzIvU2lsdmFldGFsMTVHRU9ERVJNQS5wZGY/QVdTQWNjZXNzS2V5SWQ9QUtJQUlXT1dZWUdaMlk1M1VMM0EmRXhwaXJlcz0xNTE5MjY0MDU5JlNpZ25hdHVyZT0yc2s5ajNNbVZqRHNkemt3clZXdlNwV3hEOHclM0QmcmVzcG9uc2UtY29udGVudC1kaXNwb3NpdGlvbj1pbmxpbmUlM0IlMjBmaWxlbmFtZSUzREltcHJvdmluZ19jbGF5X2NvbnRlbnRfbWVhc3VyZW1lbnRfaW5fb3gucGRmKSAgCiAgICAKLSBBZ2dyZWdhdGUgRnJhY3Rpb25hdGlvbiAKICAgICsgU3VtbWFyeSBvZiBhIHBhcGVyIAogICAgKyBIb3cgaXQgYXBwbGllcyB0byBTb2lsIEMgIAogICAgCi0gRGVuc2l0eSBGcmFjdGlvbmF0aW9uICAKICAgICsgU3VtbWFyeSBvZiBhIHBhcGVyIAogICAgKyBIb3cgaXQgYXBwbGllcyB0byBTb2lsIEMKCgoK